docs: how-to/reference sweep — typed-config consistency, runnable how-tos, auth example#686
Merged
Merged
Conversation
4 tasks
rickylabs
added
area:docs
type:docs
status:ready-merge
priority:p1
Aspire injects PORT at runtime; netscript.config.ts services.<name>.port (apps.<name>.port for Fresh apps) is the typed source of truth the scaffold wires as the fallback default. One shared sentence at each first parseInt occurrence so the raw-env read no longer reads as the canonical pattern. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VifzAytcxBk5odEMaCXihM
#8 #9 #10 #15) - reference/ai: explicit note that AI provider keys have no typed config surface; raw Deno.env.get is the supported path (#8). - reference/queue + reference/kv: See-it-live link blocks to the queue-kv-cron how-to and data-persistence concept page (#9). - reference/contracts + reference/sdk: showcase sentence per lede — contracts obviate manual req.json() validation; defineServices() wires the whole typed stack in one call (#10). - durable-workflows/streams: one sentence reframing no in-process subscribe() as an intentional single HTTP/SSE surface (#15). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VifzAytcxBk5odEMaCXihM
) discover-services, choose-a-queue-provider, and add-a-task-runtime-adapter each gain one copy-pasteable end-to-end block (resulting file + full command sequence) at deploy-local-aspire density, demonstrating the pluggability the pages previously only asserted. All commands/APIs grounded in package source. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VifzAytcxBk5odEMaCXihM
#12) A real Fresh routes/*.tsx handler gated on an active session and an admin role, at sibling auth.md's depth: resolves the session via backend.sessions.getSession, maps to a Principal with principalMapper, and fails closed on both checks. Grounded in packages/auth-better-auth + @netscript/service/auth exports. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VifzAytcxBk5odEMaCXihM
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VifzAytcxBk5odEMaCXihM
rickylabs
force-pushed
the
docs/660-howto-reference-sweep
branch
from
July 11, 2026 22:34
e25279e to
e3553e4
Compare
rickylabs
marked this pull request as ready for review
July 11, 2026 22:42
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #660 (slice B of 2 — merged after slice A; together they complete the issue's acceptance)
How-to/reference/pillar sweep per the merged docs-audit spec (proposals 7, 8, 9, 10, 11, 12, 15):
packages/configservice schema;apps.<name>.portvariant for the Fresh app page).reference/ai/index.md: explicit provider-keys-have-no-typed-config note.reference/queue|kv: "See it live" link blocks;reference/contracts|sdk: showcase ledes.discover-services,choose-a-queue-provider,add-a-task-runtime-adapter(grounded APIs only).identity-access/better-auth-plugins.md: complete session-gated route-protection example atauth.mddepth.durable-workflows/streams.md: intentional-design reframe sentence.Validation: docs verify green — 169 pages / 23,456 links; grep gate 0 hits on all 18 touched pages (worklog in-branch at
.llm/runs/docs-660b-sweep--opus/).Authored by a Claude Opus 4.8 docs agent under the beta-8 orchestrator (
4d300496); Tier-A reviewed.